From 2bbea2bc93203b8585e11d29143defdbe8accc0c Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Wed, 4 Jun 2014 21:25:05 -0400 Subject: [PATCH] Expand GtkWindowGroup docs --- gtk/gtkwindowgroup.c | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/gtk/gtkwindowgroup.c b/gtk/gtkwindowgroup.c index 2a9cd1e92a..bed78cf286 100644 --- a/gtk/gtkwindowgroup.c +++ b/gtk/gtkwindowgroup.c @@ -34,8 +34,16 @@ * @Short_description: Limit the effect of grabs * @Title: GtkWindowGroup * - * #GtkWindowGroup objects are referenced by each window in the group, - * so once you have added all windows to a #GtkWindowGroup, you can drop + * A #GtkWindowGroup restricts the effect of grabs to windows + * in the same group, thereby making window groups almost behave + * like separate applications. + * + * A window can be a member in at most one window group at a time. + * Windows that have not been explicitly assigned to a group are + * implicitly treated like windows of the default window group. + * + * GtkWindowGroup objects are referenced by each window in the group, + * so once you have added all windows to a GtkWindowGroup, you can drop * the initial reference to the window group with g_object_unref(). If the * windows in the window group are subsequently destroyed, then they will * be removed from the window group and drop their references on the window -- 2.30.2